Shareware Super Platinum 8

home *** CD-ROM | disk | FTP | other *** search

/ Shareware Super Platinum 8 / Shareware Super Platinum 8.iso / mac / PROGTOOL / ABWIL097.ZIP;1 / ABWILD.DOC < prev next >

Wrap

Text File | 1993-01-06 | 21.1 KB | 384 lines

ABWILD v0.97 - Extended Wild-card Batch-File Utility - Page 1 of 7 ========================================================================== AAAAAAAA BBBBBBBB WW WW IIIIII LL DDDDDDDDD AA AA BB BB WW WW II LL DD DD AA AA BB BB WW WW II LL DD DD AA AA BBBBBBBB WW WW II LL DD DD AAAAAAAAAAAA BBBBBBBBB WW WW II LL DD DD AAAAAAAAAAAA BB BB WW WW II LL DD DD AA AA BB BB WW W WW II LL DD DD AA AA BB BB WW WWW WW II LL DD DD AA AA BBBBBBBBB WWW WWW IIIIII LLLLLLLLLLL DDDDDDDDD ABWILD v0.97, Released January, 1993 ABWILD - (c)1993, AAB Enterprises, Inc. P.O. Box 42051 Mississauga, Ontario, CANADA L5M-4Z4 ABWILD is a productivity utility designed for knowledgeable MS-DOS users. ABWILD provides users with a method to QUICKLY and EASILY ... 1) repeat a command which does not support DOS wild-cards (*,?). 2) recurse sub-directories to a user-selected level 3) extend wild-card support to directories. 4) extend wild-card support to Alphabetic, Numeric, and Other (+,=,;). 5) create batch files for ... i) file compression ii) file conversion iii) file management iv) source compilation & linking ABWILD provides programmers with a method of externalizing code for wild-card and sub-directory support. They can therefore spend more time concentrating on the functionality of their program, instead of the "Bells & Whistles". ABWILD permits the repeated execution of another program (or batch-file). For convenience, this program (or Batch-file) will be referred to as the Subordinate Program for the remainder of this text. ABWILD v0.97 - Extended Wild-card Batch-File Utility - Page 2 of 7 ========================================================================== ABWILD v0.97 - Wild-card Batch-file Utility - (c)1993, AAB Enterprises, Inc. *** ABWILD is NOT Free or Public Domain! *** It is UNREGISTERED Shareware! *** You are encouraged to distribute ABWILD to your friends and co-workers. ABWILD must be distributed in its entirety, for no charge. Distributors may charge only a reasonable copying fee for ABWILD. Fees paid to other than AAB Enterprises, Inc. do NOT include registration. *** You must NOT modify ABWILD in any manner! *** To do so is PLAGIARISM! *** AAB Enterprises, Inc is NOT responsible for loss of Data, Programs, Time, etc. Use of ABWILD constitutes acceptance of this clause. You are hereby granted a limited licence to evaluate ABWILD over 30 days. After 30 days, you must REGISTER or REMOVE it from your system. Registration provides... i- Most recent, REGISTERED version of ABWILD without the Delay. ii- Complete, Up-to-Date & Printed Documentation for ABWILD. iii- Shareware versions of other Software Titles from AAB Enterprises, Inc. iv- Free BBS support (E.T.A. Summer/1993). v- Immunity from Prosecution, A Clear Conscience and a Good Example. *** Support Shareware! $30/copy Registration Fee! (plus $1/Node, $70max) *** AAB Enterprises, Inc, P.O.Box 42051, Mississauga, Ontario, CANADA, L5M-4Z4 Please wait... (ESC=Abort) This opening screen shown above contains information pertinent to the Shareware version of ABWILD. REGISTERED copies will only display this screen upon request. The last line of this screen, ie... Press any key... (ESC=Abort) ...will appear only the required delay interval has elapsed. This screen, the delay interval, and the requirement to press a key are the only restrictions placed on the Shareware version of this utility. ABWILD is NOT crippled in any way, and retains all the functionality of the REGISTERED version. This is the way I've chosen to encourage consistent users to purchase a registered version of this program. Therefore, please do NOT write requesting that I remove it. If you don't like it, REGISTER! *************************************************************************** *** Do NOT attempt to modify ABWILD. To do so would involve PLAGIARISM. *** *************************************************************************** Although not crippled, ABWILD does contain protection against modification. The protection will also prevent corrupted versions of ABWILD from being accidentally distributed due to Disk-Errors. If ABWILD runs at all, you can be fairly certain that you have an unmodified version. At this time, the protection is NOT complete, so do NOT assume ABWILD is free of viruses. As a normal precaution, ALWAYS use a virus scanning utility on any new programs before installation. This includes off-the-shelf, shrink-wrapped software. It has happened before, it will happen again. AAB Enterprises, Inc. has scanned ABWILD for viruses prior to release. ABWILD v0.97 - Extended Wild-card Batch-File Utility - Page 3 of 7 ========================================================================== The purpose of ABWILD, as mentioned above, is to provide extended wild-card support to Subordinate Programs which either do not have it at all or do not have enough of it. The extended part comes from the fact that ABWILD permits the use of three additional wild-card characters (ie... '+', '=' and ';'). While the normal DOS wild-cards of * and ? match ANY character in the appropriate position, the ABWILD extended wild-cards match characters selectively. To explain... i) '+' will match only Alphabetic characters. ii) '=' will match only Numeric characters. iii) ';' will match only characters which are neither Alphabetic or Numeric. In some cases, a Subordinate Program will utilize one or more of these ABWILD extended wild-card characters as part of its options. If you are using such a program under ABWILD, the Subordinate Program's option(s) will be interpreted as File-Description(s) containing wild-cards and ABWILD will operate on it accordingly. This, of course, will probably cause ABWILD to produce undesirable results. To avoid this problem, the use of ABWILD extended wild-cards is an option and may be disabled using the No-Wilder Option (ie, /NW). Additionally, the Ignore-String option (/ISxxx) can be used to instruct ABWILD to ignore an individual parameter for the purposes of File-Description modification. In this way, the ABWILD Extended Wild-card characters can still be used with programs which use these characters as part of their options. The Syntax for the ABWILD command line is very forgiving. The same can NOT be said of any program which is executed under ABWILD. ABWILD can NOT be expected to know of and correct the Syntax for every program the user may choose to use with it. Therefore, you are responsible for knowing and using the correct Syntax of the Subordinate Program. No spacing is required in the ABWILD Command-Line Options. However, as shown in the help screen, each Option must be preceded by a slash (ie... '/'). ABWILD automatically translates its own options from lower to upper case, but, does NOT translate the options &/ parameters of the Subordinate Program. Therefore, once again, you are responsible for knowing whether the Subordinate Program requires upper, lower or mixed case in its options. ABWILD permits the entry of the Subordinate Program and its parameters 3 ways. i) append the Subordinate Program, Parameters and Options to the end of the ABWILD Command-Line. ii) from a Disk-file whose name is specified in the ABWILD Command-Line using the Input-File-name option (ie, /IFxxx). iii) from the keyboard, after executing ABWILD with the Input-File-name option which specifies the CONSOLE as the input device (ie, /IFcon). The second and third methods permit the entry of multiple Subordinate Programs and their associated Parameters and Options. While the first method permits you to vary ABWILD's options for each Subordinate Program, the second and third methods cause ABWILD to retain the initial options for each of them. Please note that use of the Input-File-name option (ie, /IFxxx) causes all non-ABWILD options on the Command-Line to be ignored. This means that the first Subordinate Program input method described above can NOT be combined with the second or the third method. ABWILD v0.97 - Extended Wild-card Batch-File Utility - Page 4 of 7 ========================================================================== Something similar to the ABWILD Help screen is shown below. Subsequently, each option will be explained briefly. ------------------------------------------------------------------------------- ABWILD v0.97 - Wild-card Batch-file Utility - (c)1993, AAB Enterprises, Inc. Purpose: Provide extended Wild-card support using Batch-files. *** ABWILD is NOT Free or Public Domain! It is UNREGISTERED Shareware! *** Method: i) Find Wild-Cards(*?+=;) in Command-Line File-Descriptions. ii) Generate Batch-File with NO Wild-Cards in File-Descriptions. iii) Optionally Execute and Delete Batch-File. Syntax: ABWILD [/options] PROGRAM FileDesc [FileDesc2] [-options] Options: /A=Append !/NA=No-Append Wild.... {*} all ASCII !/B=Break /NB=No-Break-on-error Wild.... {?} any ASCII /?=Help /C=Chg-dir !/NC=No-Chg-dir /{+} any Alpha /I=Info !/D=Delete /ND=No-Delete Wilder < {=} any Digit /M=Mono /E=Echo !/NE=No-Echo \{;} any Other !/F=Files /NF=No-Files !/P=Path-add /NP=No-Path-add /P#=Primary-file-desc......1=Dflt /R=Recurse !/NR=No-Recurse /L#=Levels-to-recurse.....99=Dflt ! is /T=Trap-esc !/NT=No-Trap-escape /S#=Sub-dir-format...3/2/1/0=Dflt default /V=Verbose !/NV=No-Verbose /ISxx=Ignore-String......repeatable value !/W=Wilder /NW=No-Wilder /IFxx=Input-File...........CON=Dflt !/X=eXecute /NX=No-eXecute /OFxx=Output-File......ABW.BAT=Dflt *** Support Shareware! $30/copy Registration Fee! (plus $1/Node, $70max) *** AAB Enterprises, Inc, P.O.Box 42051, Mississauga, Ontario, CANADA, L5M-4Z4 ------------------------------------------------------------------------------- ABWILD v0.97 - Extended Wild-card Batch-File Utility - Page 5 of 7 ========================================================================== Normally, ABWILD generates a Batch-file which does not change Drives, Directories or Environment Variables during execution. However, the new option, '/C'=Change-directory causes ABWILD to insert statements into the Batch-file which WILL cause it to change to the appropriate Drive and/or Directory before executing the Sub-ordinate program. This is useful if the length of the Command-Line is greater than that permitted by DOS (ie, 128 characters). Since this option changes the current directory, the Command-line itself need not contain complete paths, so ABWILD generates statements accordingly. ABWILD requires neither Expanded or Extended memory and will execute properly on a system with only 256kB. Since the program chosen to be executed under ABWILD may be too large to fit in memory simultaneously with ABWILD, the batch-file method chosen is the most appropriate. An option, '/NX'=NoExecute was added to ABWILD to help avoid the dreaded 'Insufficent Memory' error which would otherwise occur under these circumstances. After ABWILD has created the batch-file and exited back to DOS, the user can then manually execute the batch-file. ABWILD uses only the DOS internal DIR and CD commands to perform its functions and does not utilize the MS-DOSv5.0 /S enhancement to DIR. ABWILD will therefore work with older and obscure versions of MS-DOS. ABWILD has been tested with NEC-DOSv3.2, NEC-DOSv3.3, IBM-DOSv4.01 and MS-DOSv5.00. Since ABWILD can be used to execute a program hundreds or thousands of times, a Disk-Cache and/or RAM-Drive are recommended. ABWILD v0.97 - Extended Wild-card Batch-File Utility - Page 6 of 7 ========================================================================== At this point, each option will be explained briefly. *NB!* Options preceded by the exclamation point are defaults and need not be entered. They are included for documentation purposes and clarity. All ABWILD options may be repeated on the Command-Line as many times as space permits. This is only useful with the Ignore-String option (ie, /ISxxx). Spacing between ABWILD is not required. Appropriate punctuation for the Sub-ordinate program is dependant upon its own individual requirements. Option Description /? Displays the Help Screen /I Displays the Info Screen /M Uses only Monochrome compatible colours. /A Appends Subordinate commands to existing Output-File. /NA Clears Output-File prior to appending of Subordinate commands. /B Breaks execution if a run-time error occurs in the Sub-ordinate program /NB No Break. Ignores run-time errors in the Sub-ordinate Program. /C Change-directory option. Causes ABWILD to insert the appropriate statements into the Batch-File such that it will change into the directory being operated on. This is useful if the Sub-ordinate program's Command-Lines are longer than 128 characters. /NC No-Change-directory. Opposite of /C. /D Deletes Batch-File after execution. /ND No-Delete. Does NOT delete the Batch-File after execution. /E The first command in the Output-File enables echo during execution. /NE The first command in the Output-File disables echo during execution. /F Includes Files to match Wild-cards. (related to /S#) /NF Excludes Files from matching wild-cards. /P Adds same path to non-Primary wild-card file-descriptions without one. /NP Does not add the same path to non-Primary wild-card file-descriptions. /R Enables Sub-directory recursion. (also sets /L#=99) /NR Disables Sub-directory recursion. (also sets /L#=0) /T Trap-escape causes ABWILD to add two(2) statements after each occurence of the Sub-ordinate program in the Batch-File. These statements i) execute ABTRAP 0 ii) check for ERRORLEVEL -1 from ABTRAP. if ABTRAP returns -1, the Batch-File will jump to its end LABEL, automatically inserted by ABWILD. Setting the /T option automatically disables the /B option. The ABTRAP program will automatically be executed with the /v option enabled if the ABWILD program was invoked in the same way. /NT Does not perform escape Trapping. /V Enables ABWILD's progress display. Adds '/v' to ABTRAP if '/T' is set. /NV Disables ABWILD's progress display. /W Enables ABWILD's Extended Wild-cards (ie, '+', '=' and ';') /NW Disables ABWILD's Extended Wild-cards. /X Executes Output-File after generating it. /NX Does not execute Output-File. /L# Specifies maximum number of levels of sub-directories to penetrate. (if 0, also sets /NR. if > 0, also sets /R, default=99) /S# Specfies type of Sub-Directory Name Matching (3, 2, 1 or 0=Default) 0= Sub-Directory Names not included 1= Sub-Directory Names included 2= Sub-Directory Names and Back-Slash included 3= Sub-Directory Names, Back-Slash and Wild-cards included /P# Specifies which Wild-card File-Description is to be considered primary when more than one is specified. Parameters and options ignored. From left to right, the name of the Subordinate Program is offset 0. Default is 1. /ISxxx Specifies a string which is to be ignored for the purposes of determining Wild-card File-Descriptions. ABWILD attempts to match the /ISxxx string starting from the left-most character position of the Sub-ordinate Program's parameters. Therefore the ABWILD /ISxxx option can instruct ABWILD to ignore leading strings only. /IFxxx Specifies the name of an Input-File which contains one or more Subordinate Program Command-Line(s) containing Wild-cards. If the special file-name of CON is used, ABWILD will accept multiple Sub-ordinate Command-Lines from the keyboard, terminating upon receipt of an empty line. /OFxxx Specifies the name of the Output-File into which the Subordinate Program's Command-Line(s) are to be inserted after having the Wild-cards removed from the File-Description(s). This file will be of the DOS BATch file format and may be executed. Although it is preferred that the file's extension should be .BAT, it is not required. ABWILD v0.97 - Extended Wild-card Batch-File Utility - Page 7 of 7 =========================================================================== The examples below assume ABWILD, ABCHKSUM, ABTRAP and PKZIP have been installed to a Sub-directory on the Hard-drive and a path to the appropriate Sub-directory exists. ABWILD comes with ABTRAP, a utility to permit ERRORLEVEL branching within a DOS Batch-file. There are several parameters for ABTRAP, please execute it for more detail. If you choose to use the /T option of ABWILD, please be aware of the fact that ABTRAP must be found in one of the DOS directories described in the PATH environment variable. ABWILD comes with ABCHKSUM, a utility to generate checksums for a file. ABCHKSUM does NOT support wild-cards and is therefore suitable as a test program for ABWILD. ABCHKSUM does not provide a proper ERRORLEVEL upon exiting, and therefore is a good candidate for testing the '/T'=Trap-escape option. ABCHKSUM outputs its results to the screen, and this can be re-directed to a file if desired through the use of its /OFxx option. For example... C:\>ABWILD /r/v/nx/t ABCHKSUM c:\+++*.COM /ofABCHKSUM.TXT Will generate a Batch-File called ABW.BAT in the CURRENT directory. Will recurse ALL Sub-Directories starting at C:\ Will find only .COM files whose name begins with at least 3 Alphabetics. Will generate a complete statement containing NO wild-cards. Will append the results of this execution of ABWILD onto a file called ABCHKSUM.TXT in the CURRENT Directory. Will provide verbose reporting of ABWILD's status while generating the batch-file and add the '/v' option to the ABTRAP program's options. Will NOT execute the batch-file. Since ABWILD is useful with PKZIP, an example is probably warranted. Regardless of how a system changes, a batch file containing these statements will compress an entire system of four partitions into individual .ZIP files corresponding to the name of the Sub-Directories they contain. This can be performed before backing up to Tape. This is useful if your tape drive software does not perform compression. ABWILD /v /p2 /s3 /nr /is-x*.zip PKZIP -r -P *.zip c:\*.* -x*.zip ABWILD /v /p2 /s3 /nr /is-x*.zip PKZIP -r -P *.zip d:\*.* -x*.zip ABWILD /v /p2 /s3 /nr /is-x*.zip PKZIP -r -P *.zip e:\*.* -x*.zip ABWILD /v /p2 /s3 /nr /is-x*.zip PKZIP -r -P *.zip f:\*.* -x*.zip (the above four lines can be put into a batch-file, but if you haven't registered, ABWILD will wait for keyboard input during each execution!) ...or... (for those of you who haven't registered!) ABWILD /v /p2 /s3 /nr /is-x*.zip /ifCON Additional Parameters ? pkzip -r -P *.zip c:\*.* -x*.zip Additional Parameters ? pkzip -r -P *.zip d:\*.* -x*.zip Additional Parameters ? pkzip -r -P *.zip e:\*.* -x*.zip Additional Parameters ? pkzip -r -P *.zip f:\*.* -x*.zip Additional Parameters ? (Method#2, obviously can NOT be used with a batch-file, but if you haven't registered, and can't wait around to perform keyboard input, this is your best bet!) Since the Path-add option (ie, /P) is a default, the .ZIP files will end up in the root directories of the corresponding Hard-drive Partitions. However, since there may not be enough free disk space to handle these large .ZIP files, the destinations can be changed. For example, let's assume that the drives F: and E: contain the greatest amount of free space... ABWILD /v /p2 /s3 /nr /is-x*.zip PKZIP -r -P f:\*.zip c:\*.* -x*.zip ABWILD /v /p2 /s3 /nr /is-x*.zip PKZIP -r -P f:\*.zip d:\*.* -x*.zip ABWILD /v /p2 /s3 /nr /is-x*.zip PKZIP -r -P f:\*.zip e:\*.* -x*.zip ABWILD /v /p2 /s3 /nr /is-x*.zip PKZIP -r -P e:\*.zip f:\*.* -x*.zip Since the add-Path option only operates on Wild-card File-Descriptions which specify neither Drive or Path, it is not necessary to specify /NP. This documentation will be expanded upon in future releases. Registered users will receive documentation which is both more professional in appearance and more detailed in content. For now, THAT'S ALL FOLKS! *** ABWILD is NOT Free or Public Domain! It is UNREGISTERED Shareware! *** *** Support Shareware! $20/copy Registration Fee! (plus $1/Node, $50max) *** AAB Enterprises, Inc, P.O.Box 42051, Mississauga, Ontario, CANADA, L5M-4Z4